# Protonator

_a ProtonVPN connect script_

A shell script project to connect to ProtonVPN on basically any GNU+Linux/Unix system.

## Usage

- Login to your ProtonVPN dashboard
- Take a note of your OpenVPN username and passphrase
- Download the ovpn files that you want to use
- Keep those ovpn files under "ovpns" directory
- Create a file `config/cred.txt` and put your OpenVPN username and passphrase in 2 individual lines. e.g.

`config/cred.txt`
```
someusername
somepassword
```

- Optional but recommended, encrypt your credentials. Run either one of these:
  1. No password, less security: `openssl enc -pbkdf2 -salt -in config/cred.txt -out config/cred.enc -e -a && rm config/cred.txt`
  2. Requires password, higher security: `openssl aes-256-cbc -pbkdf2 -iter 25763 -salt -in config/cred.txt -out config/cred.aes -e -a && rm config/cred.txt`
- Optionally you can configure it with `cp config.sample.sh config/config.sh` and then editing `config/config.sh` if needed.
- Open a terminal on this directory and run `./connect.sh`

## License

This project and script: MIT (Expat); <br/>
[update-resolv-conf.sh](https://github.com/ProtonVPN/scripts/blob/master/update-resolv-conf.sh): GPL

**NOTE:** Not affiliated with and not an official project of [ProtonVPN](https://protonvpn.com/).
